home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / gltexcoordpointerext.z / gltexcoordpointerext
Encoding:
Text File  |  1996-11-11  |  13.2 KB  |  199 lines

  1.  
  2.  
  3.  
  4. ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT - define an array of texture coordinates
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT( GLint _s_i_z_e,
  14.                                 GLenum _t_y_p_e,
  15.                                 GLsizei _s_t_r_i_d_e,
  16.                                 GLsizei _c_o_u_n_t,
  17.                                 const GLvoid *_p_o_i_n_t_e_r )
  18.  
  19.  
  20. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  21.      _s_i_z_e     Specifies the number of coordinates per array element. It must
  22.               be 1, 2, 3 or 4.
  23.  
  24.      _t_y_p_e     Specifies the data type of each texture coordinate.  Symbolic
  25.               constants GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT, or GGGGLLLL____DDDDOOOOUUUUBBBBLLLLEEEE____EEEEXXXXTTTT, are
  26.               accepted.
  27.  
  28.      _s_t_r_i_d_e   Specifies the byte offset between consecutive array elements.
  29.               If _s_t_r_i_d_e is zero the array elements are understood to be
  30.               tightly packed.
  31.  
  32.      _c_o_u_n_t    Specifies the number of array elements, counting from the first,
  33.               that are static.
  34.  
  35.      _p_o_i_n_t_e_r  Specifies a pointer to the first coordinate of the first element
  36.               in the array.
  37.  
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT specifies the location and data format of an array
  41.      of texture coordinates to use when rendering using the vertex array
  42.      extension.  _s_i_z_e specifies the number of coordinates per element, and
  43.      must be 1, 2, 3, or 4.  _t_y_p_e specifies the data type of each texture
  44.      coordinate and _s_t_r_i_d_e gives the byte stride from one array element to the
  45.      next allowing vertexes and attributes to be packed into a single array or
  46.      stored in separate arrays.  (Single-array storage may be more efficient
  47.      on some implementations.)  _c_o_u_n_t indicates the number of array elements
  48.      (counting from the first) that are static. Static elements may be
  49.      modified by the application, but once they are modified, the application
  50.      must explicitly respecify the array before using it for any rendering.
  51.      When a texture coordinate array is specified, _s_i_z_e, _t_y_p_e, _s_t_r_i_d_e, _c_o_u_n_t,
  52.      and _p_o_i_n_t_e_r are saved as client-side state, and static array elements may
  53.      be cached by the implementation.
  54.  
  55.      The texture coordinate array is enabled and disabled using ggggllllEEEEnnnnaaaabbbblllleeee and
  56.      ggggllllDDDDiiiissssaaaabbbblllleeee with the argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT. If enabled, the
  57.      texture coordinate array is used when ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssssEEEEXXXXTTTT or
  58.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnnttttEEEEXXXXTTTT is called.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Use ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssssEEEEXXXXTTTT to define a sequence of primitives (all of the same
  75.      type) from pre-specified vertex and vertex attribute arrays.  Use
  76.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnnttttEEEEXXXXTTTT to specify primitives by indexing vertexes and vertex
  77.      attributes.
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      Non-static array elements are not accessed until ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnnttttEEEEXXXXTTTT or
  81.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssssEEEEXXXXTTTT is executed.
  82.  
  83.      By default the texture coordinate array is disabled and it won't be
  84.      accessed when ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnnttttEEEEXXXXTTTT or ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssssEEEEXXXXTTTT is called.
  85.  
  86.  
  87.      Although it is not an error to call ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT between the
  88.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd, the
  89.      results are undefined.
  90.  
  91.  
  92.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT will typically be implemented on the client side
  93.      with no protocol.
  94.  
  95.  
  96.      Since the texture coordinate array parameters are client side state, they
  97.      are not saved or restored by ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb and ggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb.
  98.  
  99.  
  100.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT commands are not entered into display lists.
  101.  
  102.  
  103.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT is part of the EEEEXXXXTTTT____vvvveeeerrrrtttteeeexxxx____aaaarrrrrrrraaaayyyy extension, not part
  104.      of the core GL command set. If GGGGLLLL____EEEEXXXXTTTT____vvvveeeerrrrtttteeeexxxx____aaaarrrrrrrraaaayyyy is included in the
  105.      string returned by ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS,
  106.      extension EEEEXXXXTTTT____vvvveeeerrrrtttteeeexxxx____aaaarrrrrrrraaaayyyy is supported.
  107.  
  108. EEEERRRRRRRROOOORRRRSSSS
  109.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_i_z_e is not 1, 2, 3, or 4.
  110.  
  111.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not an accepted value.
  112.  
  113.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_t_r_i_d_e or _c_o_u_n_t  is negative
  114.  
  115.  
  116. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  117.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT
  118.      ggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT
  119.      ggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____TTTTYYYYPPPPEEEE____EEEEXXXXTTTT
  120.      ggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____SSSSTTTTRRRRIIIIDDDDEEEE____EEEEXXXXTTTT
  121.      ggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____CCCCOOOOUUUUNNNNTTTT____EEEEXXXXTTTT
  122.      ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvvEEEEXXXXTTTT with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____PPPPOOOOIIIINNNNTTTTEEEERRRR____EEEEXXXXTTTT
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  137.  
  138.  
  139.  
  140. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  141.      On RealityEngine, RealityEngine2, and VTX systems, do not enable or
  142.      disable GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLL____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT,
  143.      GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, or GGGGLLLL____EEEEDDDDGGGGEEEE____FFFFLLLLAAAAGGGG____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT
  144.      between a call to ggggllllNNNNeeeewwwwLLLLiiiisssstttt and the corresponding call to ggggllllEEEEnnnnddddLLLLiiiisssstttt.
  145.      Instead, enable or disable before the call to ggggllllNNNNeeeewwwwLLLLiiiisssstttt.
  146.  
  147.  
  148. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnnttttEEEEXXXXTTTT, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssssEEEEXXXXTTTT,
  150.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT, ggggllllEEEEnnnnaaaabbbblllleeee, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvvEEEEXXXXTTTT, ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT,
  151.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrrEEEEXXXXTTTT
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.